package com.uvnos4j.matilda.commons.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.uvnos4j.matilda.commons.dto.PageParam;
import com.uvnos4j.matilda.commons.dto.QueryParam;

import java.io.Serializable;
import java.util.Collection;

/**
 * 基础 Service
 * <p>
 * Description:基础 Service
 * </p>
 *
 * @author Guo.wl
 * @version v1.0.0
 * @see com.uvnos4j.matilda.commons.service
 * @since 2020-08-31 22:28:47
 */
public interface BaseService<T> {

    /**
     * 分页查询
     *
     * @param param     查询条件
     * @param pageParam 分页参数
     * @param orderBy   排序条件
     * @return 分页列表对象
     */
    IPage<T> findPage(QueryParam param, PageParam pageParam, String orderBy);

    /**
     * 插入一条记录（选择字段，策略插入）
     *
     * @param entity 实体对象
     * @return 插入结果
     */
    boolean save(T entity);

    /**
     * 根据 ID 选择修改
     *
     * @param entity 实体对象
     * @return 修改结果
     */
    boolean updateById(T entity);

    /**
     * 删除（根据ID 批量删除）
     *
     * @param idList 主键ID列表
     * @return 删除结果
     */
    boolean removeByIds(Collection<? extends Serializable> idList);

    /**
     * 导出
     *
     * @param param     查询条件
     * @param pageParam 分页参数
     * @param orderBy   排序条件
     * @param fileDest  excel文件写入路径
     */
    void export(QueryParam param, PageParam pageParam, String orderBy, String fileDest);

}